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Avertissements A 


Ce tutoriel suppose que vous connaissez (au moins basiquement) XML. 


Les exemples de documents XML utilisés dans ce document ne doivent pas être considérés comme des modèles de structuration de 
données... Ils ont été choisis pour illustrer des problématiques précises relatives à l'API DOM. Nous allons travailler sur un document XML 
constitué d'une liste de quelques pays, classés par continents. 


Les informations contenues dans ce tutoriel concernent la version 5.0.0 de PHP. Dans cette version, les fonctions DOM XML ne lancent 
pas d'exception DomException en cas d'erreur. De simples erreurs PHP (de niveaux divers) sont utilisées. 


Ce tutoriel a vocation à évoluer, et vous êtes vivement invités à participer en contactant l'auteur pour signifier les erreurs que vous y 
aurez trouvées, les nouvelles sections que vous aimeriez y voir et de manière générale toutes les modifications qui pourraient y être 
apportées. 


1. Les objets de l'extension DOM A 


A la différence de l'extension de PHP4 qui était assez procédurale, l'extension DOM de PHP5 est entièrement objet. Les principales 
classes sont les suivantes : 


e DomNode - objet nœud : documents, éléments, nœuds textuels… 

e DomDocument - objet document (hérite de DomNode) 

e DomElement - objet élément (hérite de DomNode) 

e DomAttr - objet attribut (hérite de DomNode) 

e DomNodelList - objet liste de DomNodes (ce n'est pas un tableau PHP !) 


Il existe aussi des objets DomException, qui dérivent de la classe Exception de PHP5, mais la version actuelle de l'extension ne les utilise 
pas. 


2. Le document DomDocument À 


Tout traitement de XML devrait commencer par la ligne suivante, qui instancie un objet DomDocument, sur lequel nous allons travailler : 
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Initialisation Sélectionnez 


<?php 
$dom = new DomDocument (); 
2> 


2.1. Chargement A 


Après l'appel du constructeur, on dispose d'un document XML vierge, sans élément racine. On peut créer les nouveaux éléments de 
toutes pièces, ou bien choisir de charger un document XML à partir d'un fichier sur le système de fichiers local ou à partir d'une 
variable chaîne de caractères. On utilise pour cela le nom du fichier XML, avec son chemin absolu ou relatif dans le système de 
fichiers. Chargeons le contenu de ce fichier dans notre objet $dom : 


Chargement d'un fichier XML Sélectionnez 
<?php 

$dom->load('fichier.xml'}); 
?> 


Si nous avions voulu charger le document XML à partir d'une variable (ou une chaîne statique) qui contient l'arbre XML : 
Chargement depuis une chaîne XML Sélectionnez 
<?php 


$Sdom->loadXML ($chainexML) ; 
ge 


On aurait également pu ouvrir un document HTML (grâce à la méthode DomDocument::loadHtmlFile) ou importer un document depuis 
SimpleXML (grâce à la fonction dom _import_simplexmil, qui n'est pas une méthode de DomDocument). 


2.2. Enregistrement A 


Il nous sera également utile d'enregistrer notre document XML sur le système de fichiers. Il suffit de procéder de la manière suivante 


Enregistrement d'un document XML Sélectionnez 
<?php 

$dom->save ('nouveauFichier.xml'); 
re 


Grâce à la méthode DomDocument::saveXML, qui renvoie le document comme une chaîne de caractères, on aurait pu récupérer le 
document XML dans une variable PHP. 


Enregistrement dans une variable Sélectionnez 
<?php 

$chaineXML = $dom->saveXML () ; 
Fe 


Notez que dans ce cas, on peut spécifier en paramètre une référence sur un objet DomNode, afin que seul le sous-arbre ayant cet 
objet pour racine soit transmis. 


2.3. Validation A 


L'extension DOM autorise de manière très simple la validation d'un document relativement au document DTD spécifié dans le 
document XML : 


Validation d'un document XML Sélectionnez 
<?php 
$dom->validate (); 
?> 
On notera également les méthodes DomDocument::schemaValidate, DomDocument::schemaValidateSource, 


DomDocument: :relaxNGValidate, DomDocument: :relaxNGValidateSource, qui prennent chacun un paramètre (adresse d'un fichier 
pour les unes, chaîne de caractères pour les autres), et qui permettent de valider le document par rapport, respectivement, à un 
schéma XML sur le système de fichiers, à un schéma XML dans une chaîne de caractères, à un document relaxNG sur le système de 
fichiers, et à un document relaxNG dans une chaîne de caractères. 


Toutes ces fonctions renvoient true en cas de succès, false en cas d'échec de la validation. En cas d'échec, des erreurs PHP de 
niveau Warning sont générées, décrivant les dérives par rapport au document de référence. Essayons par exemple de valider le 
document suivant par rapport à la DTD qui l'accompagne : 


test.xml Sélectionnez 


<?xml version="1.0" encoding="IS0O-8859-1" standalone="no" ?> 
<!DOCTYPE continents SYSTEM "test.dtd"> 
<continents> 
<europe> 
<pays3>France</pays3> 
<pays>Belgique</pays> 
<pays>Espagne</pays> 
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</europe> 
<asie> 
<pays>Japon</pays> 
<pays>Inde</pays> 
</asie> 
<asie /> 
</continents> 


test.dtd Sélectionnez 


<?xml version="1.0" encoding="IS0-8859-1" ?> 
<!ELEMENT continents (europe?, asie?, amerique?, afrique?, oceanie?, antarctique?)> 
<!ELEMENT europe (pays*)> 
<!ELEMENT pays (#PCDATA) > 
<!ELEMENT asie (pays*)> 
<!ELEMENT amerique (pays*)> 
<!ELEMENT afrique (pays*)> 
<!ELEMENT oceanie (pays*)> 
<!ELEMENT antarctique (pays*)> 


On obtiendra le résultat suivant : 


Warning: file:///c:/test.xml:0: Element continents content does not follow the DTD 
Expecting (europe? , asie? , amerique? , afrique? , oceanie? , antarctique?), got (europe asie asie ) in c:\siteroot\index.php on 
line 6 


Warning: file:///c:/test.xm:0: Element europe content does not follow the DTD 
Expecting (pays)*, got (pays3 pays pays ) in c:\siteroot\index.php on line 6 


Warning: file:///c:/test.xm:0: No declaration for element pays3 in c:\siteroot\index.php on line 6 
Dans le fichier XML, le document DTD peut être inclus directement, ou spécifié par SYSTEM avec un nom relatif ou absolu sur le 
système de fichiers, ou encore avec une URL HTTP. Dans la version PHP4 de l'extension php_domxml, la référence sur le système de 


fichiers n'était pas acceptée, et la validation ne se faisait pas correctement (notamment, la vérification des spécifiations +, ?, * 
pour le nombre d'éléments n'était pas faite). 


3. Lire un document A 


3.1. L'objet DomNodeList 


Tous les résultats multiples (comprenant des nœuds) que vous retournera DOM seront sous la forme d'un objet DomNodelist. Il faut 
bien garder à l'esprit qu'un DomNodeList n'est pas un tableau : il est hors de question d'accéder à ses membres avec un index 
entre crochets. 


La classe DomNodeList implémente l'interface Iterator de PHP, ce qui veut dire qu'elle a forcément les méthodes current, next, key, 
valid et rewind. On utilise rarement ces méthodes, mais en gros ça veut dire qu'on peut parcourir un Iterator (et donc un objet 
DomNodeList) dans une boucle foreach. C'est un moyen de récupérer une référence sur un objet d'un DomNodeList. Attention 
cependant : foreach travaillera sur une copie de l'objet DomNodeList. Si vous l'utilisez pour modifier le document, les modifications 
seront bien effectives mais ne seront pas visible à l'intérieur du foreach. 


L'autre moyen est une méthode qui ne vient pas de l'interface Iterator mais qui est définie par DomNodeList : item . Elle prend pour 
unique paramètre un index numérique. Ainsi le code suivant : 


récupération d'une référence à partir d'un DomNodeList Sélectionnez 
<?php 

$Selement = $listeElements->item(0); 
T 


récupère dans $element le premier objet pointé par le DomNodeList $listeElements. Si on fournit un mauvais index, la méthode ne 
renvoie rien. Si on exploite le résultat sans prendre de précautions, on récupère une erreur du style : 


Notice: Trying to get property of non-object 
3.2. Rechercher et récupérer un élément A 


Il y a plusieurs moyens de trouver des éléments. On peut récupérer l'élément racine du document (dans ce cas-là, on récupère un 
objet DomElement, et pas un DomNodeList, puisqu'il n'y a de toute manière qu'un seul élément racine) : 


Récupération de l'élément racine Sélectionnez 


<?php 
$racine = $dom->documentElement ; 
echo $racine->nodeName; 

> 


On notera que les objets DomNode (et par conséquent les objets DomElement) ont une propriété nodeName qui renvoie... le nom du 
nœud. Dans le cas d'un élément, c'est le nom de la balise. Dans le sens inverse de la propriété documentElement des objets 
DomDocument, les éléments ont une propriété ownerDocument qui est une référence sur le document. 


On peut aussi chercher un élément par la valeur de son attribut de type ID, si celui-ci est spécifié dans une DTD associée et si le 
document a été validé (si vous voulez simplement chercher un élément selon la valeur de son attribut id, il faudrait passer par un 
objet DomXPath. Peut-être, dans une prochaine version du tutoriel...) 


Recherche d'un élément Sélectionnez 
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<?php 
$cible = $dom->getElementByld ("cible"); 
2e 


Si vous voulez faire une recherche par le nom de la balise, vous pouvez utiliser DomDocument::getElementsByTagName() ou 
DomElement::getElementsByTagName(). La première version fait une recherche dans tout le document, la deuxième dans les 
descendants de l'élément considéré. Ces fonctions retournent un objet DomNodeList. 


test.xml Sélectionnez 


<?xml version="1.0" encoding="1$s0-8859-1" ?> 
<continents> 
<europe> 
<pays>France</pays> 
<pays>Belgique</pays> 
<pays>Espagne</pays> 
</europe> 
<asie> 
<pays>Japon</pays> 
<pays>Inde</pays> 
</asie> 
</continents> 


recherche d'éléments Sélectionnez 


<?php 
$dom = new DomDocument; 
$Sdom->load("test.xml"); 
$listePays = $Sdom->getElementsByTagName ('pays'); 
foreach ($listePays as $pays) 
echo $pays->firstChild->nodeValue . "<br />"; 


echo "---<br />"; 


$Seurope = $dom->getElementsByTagName ('europe')->item(0); 
$listePaysEurope = $europe->getElementsByTagName ('pays'); 
foreach ($listePaysEurope as $pays) 
echo $pays->firstChild->nodeValue . "<br />"; 
2 


Trace du script Sélectionnez 


France 
Belgique 
Espagne 
Japon 
Inde 
France 
Belgique 
Espagne 


On notera la propriété nodeValue des objets DomNode, qui dans le cas de nos objets DomElement et associée à DomNode- 
>firstChild, permet de récupérer la valeur du nœud textuel fils. 


3.3. Lire les attributs A 


Nous allons maintenant modifier un peu notre fichier XML (à la main), pour ajouter des attributs donnant le régime politique des pays 
cités (on suppose que la DTD aura également été modifiée en conséquence, si l'on veut profiter de la validation) : 


Sélectionnez 


<?xml version="1.0" encoding="1$0-8859-1" standalone="no" ?> 
<!DOCTYPE continents SYSTEM "test.dtd"> 
<continents> 
<europe> 
<pays regime="republique">France</pays> 
<pays regime="monarchie constitutionnelle">Belgique</pays> 
<pays regime="monarchie constitutionnelle">Espagne</pays> 
</europe> 
<asie> 
<pays regime="empire">Japon</pays> 
<pays>Inde</pays> 
</asie> 
</continents> 


Lorsqu'on dispose de l'objet élément XML qui nous intéresse, on peut lire ses attributs grâce à DomElement::getAttribute(). C'est la 
manière la plus simple : on passe le nom de l'attribut à récupérer en paramètre, et on récupère sa valeur. Une bonne habitude pour 
éviter les erreurs est de vérifier l'existence de l'attribut avec la fonction DomElement::hasAttribute(), qui prend aussi le nom de 
l'attribut en paramètre, et qui renvoie un booléen qui dit si l'attribut est présent ou pas. 


Sélectionnez 


<?php 
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$listePays = $dom->getElementsByTagName ("pays"); 
foreach ($listePays as $pays) 
{ 
echo $pays->nodeValue; 
if ($pays->hasAttribute ("regime")) { 
echo " - " , $pays->getAttribute ("regime"); 
} 
echo Er 
} 
= 


Ce qui nous donne en sortie : 


Trace du script Sélectionnez 


France - republique 

Belgique - monarchie constitutionnelle 
Espagne - monarchie constitutionnelle 
Japon - empire 

Inde 


3.4. Lire les nœuds textuels A 


On l'a déjà vu, on peut récupérer la valeur d'un nœud textuel avec l'attribut nodeValue. D'un point de vue très général, nodeValue 
donne la valeur d'un nœud, à savoir le contenu pour un nœud textuel, ou la valeur d'un attribut. 


On sait qu'un nœud textuel en lui-même ("France", par exemple) est le premier descendant de l'élément qui le contient (<pays>). 
Cependant, curiosité de DOM, appeler nodeValue sur le parent du nœud textuel revient à l'appeler sur le nœud textuel lui-même : 


Sélectionnez 


<?php 
$pays = $dom->getElementsByTagName ("pays"); 
foreach ($pays as $c) 
{ 
echo $c->nodeValue . " " . $c->firstChild->nodeValue; 
echo Y-pr >T 
} 


me 


Trace du script Sélectionnez 


France France 
Belgique Belgique 
Espagne Espagne 
Japon Japon 

Inde Inde 


On notera que si le fichier XML est indenté, la présence d'espaces, de tabulations et de retours à la ligne génère des nœuds 
textuels. Soyez donc attentifs à appliquer la fonction trim (ou un équivalent) sur vos valeurs texuelles, et/ou à vérifier si votre 
nœud textuel est vide ou pas. 


4. Modifier. un document A 


Voyons maintenant comment modifier les différents éléments d'un document XML déjà existant. 


4.1. Créer unnœud A 


La méthode DomDocument::createElement permet, très simplement, de créer des éléments XML, en passant en paramètre le nom du 
nœud. 


Création d'un élément Sélectionnez 
<?php 

SnouveauPays = $dom->createElement ("pays"); 
Le 


Il faut bien noter que si $nouveauPays pointe maintenant vers un nouvel élément "pays", cet élément n'est pas encore positionné 
dans l'arbre XML. Il a été créé, mais pas intégré au document. 


Si nous voulons ajouter un nœud textuel à cet élément (pour donner un nom de pays, si nous suivons notre exemple), il faut appeler 
DomDocument::createTextNode pour créer le nœud textuel. La méthode prend en paramètre le texte à insérer Encore une fois, le 
nœud textuel est créé, mais pas intégré au document, ni même rattaché à notre nouvel élément. 


Création d'un nœud textuel Sélectionnez 
<php 

$nomPays = $dom->createTextNode ("Royaume-Uni"); 
?7> 


On notera aussi la présence de la méthode DomNode::cloneNode, qui crée un nouveau nœud (de n'importe quelle type) par copie 
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d'un nœud existant : 


Création d'un nœud par copie Sélectionnez 
<?php 

$paysidentique = $pays->cloneNode (); 
Le 


Cette dernière méthode accepte un argument facultatif, un booléen (FALSE par défaut). S'il est à TRUE, tout les nœuds fils seront 
copiés également, et donc toute une partie de l'arborescence peut être dupliquée par ce biais. 


4.2. Modifier un attribut A 


Il nous faut maintenant ajouter un attribut à notre nouveau nœud, afin de préciser le régime politique, conformément au reste du 
document XML qui nous sert d'exemple. Pour cela, nous allons utiliser DomElement::setAttribute, qui nous sert à la fois à créer un 
attribut et à en modifier la valeur. Le premier paramètre est le nom de l'attribut, et bien évidemment le second est sa valeur. 


Création ou modification d'attribut Sélectionnez 


<?php 
SnouveauPays->setAttribute "regime", "monarchie constitutionnelle"); 
?> 


On peut supprimer un attribut avec DomElement::removeAttribute (avec le nom de l'attribut en paramètre). 
4.3. Insérer un næud dans le document A 


Nous avons vu comment créer les éléments et les nœuds textuels, mais encore faut-il les placer dans le document XML, et au bon 
endroit. L'insertion se fait par la méthode DomNode::appendChild, qui ajoute le nœud passé en paramètre à la liste des enfants du 
nœud sur lequel il est appelé. Le script suivant ajoute le nœud textuel $nomPays à notre nouveau nœud $nouveauPays, et ajoute 
ensuite celui-ci au nœud "europe". 


Insertion de nouveaux éléments Sélectionnez 


<?php 
$SnouveauPays->appendChild($nomPays) ; 
$Seurope = $dom->getElementsByTagName ("europe")->item(0); 
Seurope->appendChild(S$nouveauPays) ; 

PE 


4.4. Supprimer un næud A 


Finissons par le plus triste : vous ne voulez plus de votre nœud, et plutôt que de l'abandonner au bord de l'autoroute au départ des 
grandes vacances, vous allez l'euthanasier. Pour cela, vous utiliserez la terrible méthode DomNode: :removeChild, en l'appelant sur le 
parent du nœud à supprimer et en passant en paramètre une référence sur le nœud à supprimer Bien évidemment, tous les 
descendants du nœud supprimé seront également exterminés. Puisqu'il le faut, supprimons donc le nœud que nous avons eu tant de 
mal à créer ! 


Anéantissement de notre beau nœud tout neuf Sélectionnez 
<?php 


$europe->removeChild($nouveauPays) ; 
ee 


5. Exemple simple (et inutile) : conversion XML / objets PHP 


La fonction suivante prend en paramètre le nom d'un fichier XML accessible, le valide, et en extrait un objet PHP5 reprenant 
l'architecture du document XML. Chaque objet élément a quatre membres : son nom (chaîne de caractères), sa valeur CDATA (chaîne de 
caractères, vide au besoin), un tableau associatif "attributes" qui reprend les couples nonyvaleur des attributs et un tableau "children" 
qui reprend les éléments fils. Les commentaires et la lecture de ce tutoriel devraient suffire à la compréhension du code. Notez que cette 
fonction est d'un intérêt limité, car on souhaite qu'elle s'adapte à toute forme de document, elle ne constitue donc qu'une piètre 
surcouche de la fonction DomDocument->load. Par contre, une fonction de ce type, spécialisée pour une classe particulière, peut être 
d'une grande utilité dans une application PHP5 utilisant des fichiers XML comme sources de données ou de paramétrage. 


conversion XML vers objet Sélectionnez 


<?php 
function fileToObject ($fileName) { 


// création du nouvel objet document 
$dom = new DomDocument () ; 


// chargement à partir du fichier 
$dom->load($fileName); 


// validation à partir de la DTD référencée dans le document. 
// En cas d'erreur, on ne va pas plus loin 
if ('@S$dom->validate()) { 
return false; 
} 


// création de l'objet résultat 
$object = new stdClass (); 
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// on référence l'ad e du fichier source 
$Sobject->source = $fileName; 


ère l'élément 


" 


// de t nommé “root! 
$root = $dom->documentElement; 


$Sobject->root = new stdClass (); 


HMS AE nfa 
getElement ($root, $object->root); 


return $object; 


?> 


Et voilà la fonction récursive qui parcourt l'arbre XML : 
conversion XML vers objet - parcours d'arbre 


<?php 
function getElement ($dom element, $object element) { 


// récupération du nom de l'élément 
$object element -name = $dom element->nodeName; 


i 


He 


// en supprimant le: paces 
$object element->textValue = trim($dom element->firstChild->nodeValue) ; 


de formatage. 


$object element->attributes = array(); 
foreach ($dom element->attributes as $attName=>$dom attribute) { 
$object element->attributes[$attName] = $dom attribute->value; 


éléments fils 


/4 1e nocud text 

if ($dom element->childNodes->length > 1) { 

$object element->children = array); 

foreach ($dom element->childNodes as $dom child) { 

if ($dom child->nodeType == XML ELEMENT NODE) { 

$child object = new stdClass (); 
getElement ($dom child, schild object); 
array push($object element->children, $child object); 


Voyons maintenant l'objet créé par cette fonction, si on l'applique au fichier XML sur lequel nous avons travaillé : 
affichage de l'objet résultat 


<?php 
echo "<pre>"; 
print r(fileToObject ("test.xml")); 
echo "</pre>"; 

> 


trace d'exécution 


stdClass Object 
( 
[source] => test.xml 
[root] => stdClass Object 
( 
[name] => continents 
[textValue] => 
[children] => Array 
( 
[0] => stdClass Object 
( 
[name] => europe 
[textValue] => 
[children] => Array 
( 
[0] => stdClass Object 
( 
[name] => pays 
[textValue] => France 
[attributes] => Array 
( 


Sélectionnez 


Sélectionnez 


Sélectionnez 
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[regime] 


) 


[1] => stdClass Object 
( 


[name] => pays 


[textValue] => Belgique 
[attributes] => Array 


( 


[regime] 


) 
) 
[2] => stdClass Object 


( 


[name] => pays 


[textValue] => Espagne 
[attributes] => Array 


( 


[regime] 


) 


) 


[1] => stdClass Object 
( 

[name] => asie 

[textValue] => 

[children] => Array 

( 
[0] => stdClass Object 
( 


[name] => pays 


[textValue] => Japon 
[attributes] => Array 


( 


[regime] 


) 
) 
[1] => stdClass Object 


( 


[name] => pays 


[textValue] => Inde 


=> republique 


=> monarchie constitutionnelle 


=> monarchie constitutionnelle 


La seconde fonction que nous allons voir fait l'opération inverse : à partir d'un objet créé par la première fonction, elle écrit dans un 


fichier XML (à supposer que les droits d'écriture soient accordés au serveur, bien entendu). 


Voilà maintenant la fonction qui prend en paramètre un objet tel que créé précédemment, et qui l'écrit sur le disque sous la forme d'un 


document XML. C'est la conversion inverse, en somme. 
conversion objet vers XML 


<?php 
function ObjectToFile ($xmlObject) { 


$dom = new DomDocument () ; 


$root = $dom->createElement ($xmlObject->root->name) ; 
$dom->appendChild($root); 


setElement ($dom, S$SxmlObject->root, $root); 


Sdom->save ($xmlObject->source); 
echo $xmlObject->source; 
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Comme précédemment, cette fonction fait appel à une fonction récursive de parcours d'arbre en profondeur : 
conversion objet vers XML - parcours d'arbre Sélectionnez 


<?php 
function setElement ($dom document, $object element, $dom element) { 


// récupération de la valeur CDATA de l'élément 

if (isset($object element->textValue)) { 
$cdata = $dom document->createTextNode ($Sobject element->textValue); 
$dom element->appendChild($cdata) ; 

} 


// récupération des attributs 
if (isset ($object element->attributes)) í 
foreach ($object element->attributes as $attName=>SattValue) { 
$dom element->setAttribute ($attName, $attValue); 
} 
} 


// construction des éléments fils, et parcours de l'arbre 
if (isset($object element->children)) { 
foreach ($object element->children as $childObject) { 
Schild = $dom document->createElement ($childObject->name) ; 
setElement ($dom document, $childObject, $child); 
$dom element->appendChild($child); 


6. Fonctions avancées A 


Cette section s'étoffera au fur et à mesure de vos questions et suggestions. 
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Bibliographie et liens A 


e Documentation officielle : DÌ PHP : Fonctions DOM 

e Pour PHP4 : Ell'extention PECL DOM XML 

e Pour assurer la compatibilité PHP4- DOMXML / PHP5-DOM, par Alexandre Alapetite : Dl Transition du XML de PHP4 dom_xml à PHP5 
dom 

e D'autres moyens de traiter du XML en PHP : H l'interface SAX, H l'extension SimpleXML (seulement sur PHP5). 


e HUn article sur SimpleXML par Stéphane Eyskens. 
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